home *** CD-ROM | disk | FTP | other *** search
/ EuroCD 3 / EuroCD 3.iso / Utilities / Workbench / FullPalette / DocsEnglish / FullPalette.doc < prev   
Encoding:
Text File  |  1998-06-24  |  10.6 KB  |  280 lines
  1.  
  2.  
  3.               =================================================
  4.               FullPalette 40.19 (9.11.97) by Massimo Tantignone
  5.               =================================================
  6.  
  7.  
  8.    INTRODUCTION
  9.  
  10.    FullPalette is a patch that, together with a preferences editor, allows
  11. you to define and save ALL the 256 Workbench colors and not just eight of
  12. them as the standard Palette editor does.
  13.  
  14.    You can decide exactly which colors are to be "locked", and thus never
  15. modified by programs running on the Workbench screen, and which colors
  16. instead are to be left "free" for IPrefs and other applications.
  17.  
  18.    Among other advantages, this makes the managing of icons much easier;
  19. using FullPalette you can, for example, have icons with any number of
  20. colors without risking to see some of them change just because you view
  21. a picture with MultiView on the Workbench screen.
  22.    You could also set colors 4-7 to always be the same as colors 252-255.
  23.  
  24.    FullPalette also has a button strip to easily perform editing actions
  25. such as "Copy", "Swap" and "Spread".
  26.  
  27.    For the purpose of editing the Workbench palette, FullPalette can
  28. wholly replace the standard "Palette" preferences editor, whose settings
  29. file (palette.prefs) it continues to maintain for compatibility, although
  30. FullPalette also uses a custom file.
  31.  
  32.    The patch runs alongside IPrefs with no conflicts.
  33.  
  34.  
  35.    INSTALLATION
  36.  
  37.    Installing FullPalette is very simple. You only have to do three things:
  38.  
  39.    1) Copy the FPPrefs program into a directory that is in the system path
  40.       (for example C:)
  41.  
  42.    2) Insert into your Startup-sequence, IMMEDIATELY AFTER IPREFS, the
  43.       following line:
  44.  
  45.       Run > NIL: FPPrefs
  46.  
  47.    3) Copy the FullPalette editor (with its icon) into the Prefs drawer
  48.       of your Workbench partition.
  49.  
  50.    Now you can reboot to activate the patch, then play with the editor to
  51. edit and save the Workbench palette according to your preferences.
  52.    The Workbench screen will use your palette each time it (re)opens itself.
  53.  
  54.    Note: you CAN'T call FPPrefs from the User-startup; if you do, some images
  55. (especially backgrounds) on the Workbench screen could be rendered with
  56. the wrong colors.
  57.  
  58.  
  59.    USAGE
  60.  
  61.    Once you have the FPPrefs patch running in the background you can use
  62. the FullPalette editor to define your palette.
  63.  
  64.    To edit the entire palette of the Workbench screen, you should first open
  65. it with the maximum number of colors available (256 for AGA and graphic
  66. cards, 16 for ECS).
  67.  
  68.    This way, you can edit all colors; then, each time the Workbench screen
  69. will open at less than its maximum depth, only some of the colors will be
  70. used.
  71.  
  72.    The FullPalette GUI is very intuitive. You have some gadgets to perform
  73. actions like "Copy" or "Spread" at the top of the window; below there is
  74. a palette gadget for choosing the palette entry to edit, and a cycle
  75. gadget to specify if you want the current color to be "Free" or "Locked".
  76.  
  77.    There are also two text indicators with the logical and physical number of
  78. the current color. The logical number ("Screen color") is the color index in
  79. the current screen's palette, whereas the physical number ("Palette color")
  80. always refers to the color index in the full 256-color palette.
  81.  
  82.    Three sliders allow you to modify the Red, Green and Blue components of
  83. the current color, and the gadgets at the bottom of the window give you
  84. the option to Save, Use or Cancel the current settings.
  85.  
  86.    You can use some tool types in FullPalette's icon (or keywords on the
  87. command line):
  88.  
  89.    SCREEN          tells FullPalette to open on a custom screen
  90.    FONTNAME=<name> specifies the name of the font for the editor window
  91.    FONTSIZE=<size> specifies the size of the font for the editor window
  92.  
  93.    Furthermore, the editor recognizes the usual preferences tool types,
  94. such as EDIT, SAVE, USE and CREATEICONS=<YES|NO>.
  95.  
  96.    Starting with version 40.14, FullPalette allows you to choose the
  97. precision of the color remapping for Workbench backdrop images.
  98.    You can select the wanted precision within the menu "Options"; if you
  99. choose "Ignore", FullPalette won't interfere with the remapping at all.
  100.    Note that any change takes effect only when the Workbench screen is
  101. reopened.
  102.  
  103.  
  104.    BEHAVIOR WHEN STARTING
  105.  
  106.    By default, FullPalette immediately sets the Workbench colors to your
  107. preferences when it starts. At boot time, this has the side effect of opening
  108. the Workbench screen if it isn't already open.
  109.    You can tell it to wait until the Workbench screen (re)opens itself by
  110. setting the environment variable "ENV:FullPalette/Action".
  111.  
  112.    With the command "SetEnv FullPalette/Action IMMEDIATE" you tell
  113. FullPalette to immediately set the colors when it is launched, thus opening
  114. the Workbench screen if it isn't already open. This is the default.
  115.  
  116.    With the command "SetEnv FullPalette/Action DEFERRED" you tell
  117. FullPalette to wait until the Workbench screen opens by itself before
  118. setting the colors.
  119.  
  120.    Once you have set the variable, make sure you copy them into ENVARC:
  121. with, for instance, the command "Copy ENV:FullPalette/#? ENVARC:FullPalette"
  122. (the ENVARC:FullPalette directory must be created first).
  123.  
  124.    Note: the "deferred" behavior is experimental, normally it works well but
  125. it seems that once in a while it can lock up the screen at boot time. If
  126. this happens, just do a manual reset (CTRL-Amiga-Amiga).
  127.    If it happens too often on your machine, return to the default behavior
  128. (immediate) by deleting the environment variable.
  129.  
  130.  
  131.    THE COLOR MODE
  132.  
  133.    You can set the environment variable "ENV:FullPalette/ColorMode" to choose
  134. how FullPalette should remap the full (physical) 256-color palette to
  135. the current (logical) color palette of the Workbench screen, if it has less
  136. than 256 colors.
  137.  
  138.    With the command "SetEnv FullPalette/ColorMode WORKBENCH" you tell
  139. FullPalette to set the current palette's first half to the colors at the
  140. beginning of the full 256-color palette, and the second half to the colors
  141. at the end. In other words, a 32-color Workbench screen will get its first
  142. 16 colors from the first 16 colors of the 256-color palette, and its second
  143. 16 colors from the LAST 16 colors of the 256-color palette.
  144.  
  145.    With the command "SetEnv FullPalette/ColorMode LINEAR" you tell
  146. FullPalette to set the current palette to the first colors of the 256-color
  147. palette, except for the last 4 color which will be always taken from the
  148. end of the 256-color palette.
  149.    This way, a 32-color Workbench screen will get its first 28 colors from
  150. the first 28 colors of the 256-color palette, and its last 4 colors from
  151. the last 4 colors of the 256-color palette.
  152.  
  153.    Either way, this is compatible with IPrefs, which uses the notorious
  154. "first 4/last 4" color scheme.
  155.  
  156.  
  157.    COLOR COPYING
  158.  
  159.    Although it isn't really necessary (you could do it by hand), starting
  160. with version 40.18 FullPalette offers the automatic copying of the last
  161. four colors in the palette to the second four colors (colors 4-7). To
  162. achieve this, just set the environment variable "FullPalette/CopyColors" to
  163. "TRUE".
  164.    It is read at launch time only, so for it to take effect you must first
  165. reboot your Amiga; furthermore, the copying takes place only for those of
  166. the destination colors (4-7) which are "Locked".
  167.    Note: in this mode, the settings for colors 4-7 shown in the FullPalette
  168. editor are ignored.
  169.  
  170.  
  171.    NOTES
  172.  
  173.    At the moment FullPalette doesn't have a color wheel, and probably it
  174. never will, as it would be impossible to allocate all the necessary pens
  175. for it from the same palette the wheel would be used to modify.
  176.    From my personal experience, however, the color wheel is rather useless
  177. in an application like this one (a palette editor for the Workbench screen).
  178.  
  179.    Furthermore, at the moment it also lacks an HSB mode as an alternative
  180. to the RGB one; if I'll receive enough requests, I'll implement it for sure.
  181.  
  182.    Important: if the cycle gadget of the editor says "Free", this does NOT
  183. mean that the selected color is _currently_ free, but just that it will
  184. never be locked by FullPalette!
  185.    However, it's possibile to know which pens are currently free or
  186. allocated: by pressing any SHIFT key while selecting (with a mouse click)
  187. a palette color, if the corresponding pen is allocated you'll see the
  188. screen flash.
  189.  
  190.  
  191.    CHANGES
  192.  
  193.    40.12    First public beta release
  194.  
  195.    40.13    Some bug-fixes:
  196.  
  197.             · Now FPPrefs doesn't change a palette entry if it wasn't
  198.               saved as "Locked".
  199.  
  200.             · Now FPPrefs does nothing when OpenWorkBench() is called with
  201.               the Workbench screen already open.
  202.  
  203.             · The FullPalette editor now saves and loads only the colors
  204.               which are "Locked".
  205.  
  206.    40.14    Bug-fix:
  207.  
  208.             · Now FPPrefs should work better with NewIcons.
  209.  
  210.             New:
  211.  
  212.             · Added (experimental) option for choosing the precision
  213.               of the Workbench pattern remapping. Let me know if it works!
  214.  
  215.    40.15    Bug-fix:
  216.  
  217.             · There was a bug in the italian .catalog file.
  218.  
  219.             New:
  220.  
  221.             · Now the editor allocates the needed stack by itself.
  222.  
  223.    40.16    Bumped revision to 16 for the Aminet release
  224.  
  225.    40.17    Bug-fix:
  226.  
  227.             · Fixed a bug in the editor, wasn't always leaving enough
  228.               space for the slider level numbers.
  229.  
  230.             New:
  231.  
  232.             · Added the (still experimental) ability to defer the setting
  233.               of colors at boot time, thus avoiding an unwanted opening of
  234.               the Workbench screen.
  235.  
  236.    40.18    Bug-fixes:
  237.  
  238.             · Added a workaround for a bug in the V39 gadtools.library
  239.               concerning the displaying of the contents of the color number
  240.               indicators. Hope it works!
  241.  
  242.             · The "Options->WBPattern remapping" menu is now correctly
  243.               updated when you select "Last saved" from the "Edit" menu.
  244.  
  245.             New:
  246.  
  247.             · Added "Ignore" to the pattern remapping options.
  248.  
  249.             · A new environment variable now allows to have automatic
  250.               copying of the last four palette colors to colors 4-7.
  251.  
  252.    40.19    Some bug-fixes:
  253.  
  254.             · Fixed a bug in the editor, wasn't always leaving enough
  255.               space for the slider level numbers (again :-).
  256.  
  257.             · Now lock-ups of the Workbench screen at boot time should
  258.               happen much less frequently, if ever.
  259.  
  260.  
  261.    CONCLUSION
  262.  
  263.    I have used FullPalette on my system for many months now, and it never
  264. gave me any trouble. However, this doesn't necessarily mean it is bug-free.
  265.    So, if you should encounter any problem with FullPalette, don't hesitate
  266. to contact me.
  267.  
  268.    For any comment, suggestion or bug report about FullPalette, write to:
  269.  
  270.    Massimo Tantignone
  271.    Via Campagnoli, 4
  272.    28100 Novara (NO)
  273.    ITALY
  274.  
  275.    E-mail: tanti@intercom.it
  276.  
  277.    I can't guarantee an immediate reply to everyone, but I'll certainly
  278. read all of your mails.
  279.  
  280.